Enhance Your Custom Menus
Copywrite 2001 by Samuel Stearley
_________________________________________________________






Introduction:
_______________________________________________________
A long wanted feature of tios is the ability to
make a custom menu and be able to choose an option
and have code execute instantly with nothing pasted to
the entry line.

This allows people to do just that.

It is mostly made up of the program executing code of
shortcuts, with some extra code at the beginning to
check for the right circumstances.  It took about 1/2
hour to write and debug.





Usage:
________________________________________________________
Send it to your calc, and execute it.  It is an event
hook and installs as such.  Because of protection
schemes by ti, If you have a hw2 calc with AMS > 2.00
you will also need h220xstr by Kevin Kofler.  See the
readme of his event hook uninstaller for his web page.



If you want an option to auto execute upon its
selection you have to put character 18 followed by
the name of the program to execute.

Character 18 is the right pointing arrow used when doing
conversions and is available on the keyboard.  From hence
forth in this documentation I will use a '>' (greater than)
to signify this character.



Example:

:Custom
:Title "Test"
: item ">yapt"
: item ">billy"
: item ">hex"
:Title ">eqw"
:EndCustom


The program may be asm or basic.  Do not include parenthesis behind
it.  If the variable does not exist, or if that variable exists but
is not a basic or asm program the text is pasted.  ie: if billy does
not exist on the calc and it is selected then the text ">billy" is
pasted.

So there shouldn't be complications if you have ">hex", which is for
hexadecimal conversions, in a menu.

Whenever you select something from a custom menu, it always sends the
text to the current app to be pasted.  Some apps like the graphing app
don't do anything with the text.  Regardless of how the app handles
the text, the text will still be caught and the program will be executed.
So this will works even if the app is the graph app.

But I have gotten odd results when I executed yapt this way.  The
coordinates of the cursor were being displayed in the small font.





Uninstallation:
_________________________________________________________________________
Use the included program Uninevhk.  It is written by Kevin Kofler and
it has it's own documentation and liscence.  Be sure to read it if you
have not already.





Liscence:
__________________________________________________________________________
This is freeware.  As such I do not guarantee anything and I am not
responsible for anything.  It may be freely distributed as long as no
profit is made on that distribution.  If profit is made then my
permission is needed.





Contacting the Author:
__________________________________________________________________________
I may be contacted by email at sstear70@calvin.edu.  When reporting bugs
please tell me your AMS version, Hardware version, kernel installed,
version of that kernel, and any other tsrs that you might have installed.



As always thanks go to Kevin Kofler, Zeljko Juric, and Rusty Wagner.